home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d3 / popedit.arc / POPEDIT.DOC < prev   
Text File  |  1988-04-20  |  10KB  |  193 lines
  1.  
  2.  
  3.                 PopEdit - Underdog's Universal PopUp Screen Editor
  4.  
  5.                   POPEDIT, SPOP, LPOP are copyright (C) 1986 by:
  6.                        Crater Rim and Procrustion Software
  7.                       4028 41st Ave So.  Seattle, Wa. 98118
  8.  
  9.         
  10.             PopEdit is a unique program which allows the user to  create, 
  11.         edit  and  save  an  unlimited  number  of  memory resident PopUp 
  12.         Screens which may be loaded into memory as pages  and  called  up 
  13.         upon  request,  in  any  application.  The user has the option of 
  14.         creating a small (20 line by 29 column) or large (24 line  by  62 
  15.         column) Memory Resident PopUp Screen.  Additionally, the user may 
  16.         reload an existing PopUp Screen into PopEdit  and  modify  it  as 
  17.         required. 
  18.             Running PopEdit is pretty straight forward so I wont bore you 
  19.         with alot of words here.  The main thing to remember is that  the 
  20.         editor  in itself is non-destructive as long as you do not answer 
  21.         'Y'  to the  'save PopUp'  prompt!  In other words,  you may play 
  22.         with  PopEdit  all  day  long without damaging any existing PopUp 
  23.         files.  Answering  'N'  to the  'save PopUp'  prompt will  simply 
  24.         return you to DOS.
  25.             Due  to the fact that the user may create two different sized 
  26.         PopUps,  it should be noted that some of the  information  within 
  27.         the  program  will  change  according  to the size screen you are 
  28.         working on. These changes are: 
  29.  
  30.          - LPOP.COM is the Default PopUp filename for the large PopUp
  31.         
  32.          - SPOP.COM is the Default PopUp filename for the small PopUp
  33.         
  34.          - Ctrl-LeftShift  is the default 'trigger' for the large PopUp
  35.         
  36.          - Ctrl-RightShift is the default 'trigger' for the small PopUp
  37.         
  38.         Getting Started
  39.         ~~~~~~~~~~~~~~~
  40.             Since PopEdit is destructive to any  existing  files  holding 
  41.         the  default  PopUp filenames (LPOP.COM and SPOP.COM),  make sure 
  42.         you make a backup copy of your original files each and every time 
  43.         you start up PopEdit.  Once you have executed PopEdit you will be 
  44.         asked if you wish to edit a Small or Large PopUp.  
  45.             Make your selection by pressing 'S' or 'L'  (upper  or  lower 
  46.         case).  In most cases,  you do not have to press [ENTER].  If you 
  47.         select 'Q' at this point, you will exit right back to DOS.  
  48.  
  49.  
  50.  
  51.         The Main Menu
  52.         ~~~~~~~~~~~~~
  53.         Your options are pretty well self explanitory:
  54.         
  55.             C)hange PopUp size - allows you to change from one size PopUp
  56.                  to the other.
  57.  
  58.             D)isk write PopUp - allows you to  save  your  present  PopUp 
  59.                  without  having  to  exit  to  DOS.  This  opens up your 
  60.                  working screen so that  you  may  create  another  PopUp 
  61.                  screen.
  62.  
  63.             E)dit current PopUp - allows you to edit the PopUp screen
  64.         
  65.             H)elp with PopEdit - will display a short tutorial  on  using 
  66.                  PopEdit and its associated PopUp screens 
  67.         
  68.             O)rder Form - There is a built in  licensing  agreement/order 
  69.                  form  which  will  print  out  either  to your screen or 
  70.                  printer - your option.  
  71.                
  72.                WARNING to ALL USERS: You MUST comply with the information 
  73.                                      contained in this section.  
  74.  
  75.             R)ead in an existing PopUp -  prompts  you  for  a  filename, 
  76.                  reads  in  that  file  and  goes immediately to the edit 
  77.                  section.  Be SURE the filename you specify is  the  same 
  78.                  size as the choice you made upon startup!  
  79.         
  80.             S)et border and colors  -  allows  you to choose  between two 
  81.                  different types of borders and a multitude of foreground 
  82.                  and background colors for both text and border.  
  83.         
  84.             Q)uit PopEdit - This is  your exit command.  If you have made 
  85.                  any changes to the PopUp you were editing,  your present 
  86.                  screen  will  be  displayed and you will be asked if you 
  87.                  wish to save it.  
  88.  
  89.  
  90.  
  91.         Editing the PopUp Screen
  92.         ~~~~~~~~~~~~~~~~~~~~~~~~
  93.             You  will  have  the full PopUp displayed to you while in the 
  94.         Edit mode. You simply have to specify which line you wish to edit 
  95.         and the cursor will  be  placed  on  that  line.  When  you  have 
  96.         finished with that line, simply hit [ENTER] and your text will be 
  97.         stored into the PopUp.  Don't worry if you go past the end of the 
  98.         line during your input as only the one line will be  stored.  The 
  99.         entire  screen  will  be  restored once you hit [ENTER].  Several 
  100.         points here: 
  101.         
  102.             While editing a line,  hitting the [Home] key will erase  the 
  103.                present line and return you to the start of that line.  
  104.         
  105.             While  editing  a line,  hitting [ENTER] alone will erase the 
  106.                previous line,  thus blanking out that line in  the  PopUP 
  107.                buffer.  
  108.  
  109.             If you have just completed editing a line, if you hit [ENTER] 
  110.                at the  'which line' prompt,  you will be returned to that 
  111.                line once again.  Remember that an additional  [ENTER]  at 
  112.                this point will erase whatever you had on that line!  
  113.  
  114.             Once you have finished editing,  simply enter 0 and you will 
  115.         be returned to the main menu screen.  
  116.  
  117.  
  118.         Setting Border and Colors
  119.         ~~~~~~~~~~~~~~~~~~~~~~~~~
  120.             Again,  you will be working with the full PopUp screen.  This 
  121.         time there wont be any line numbers though as your  changes  here 
  122.         effect  the  overall  screen.  Your  prompt  line in this section 
  123.         depicts the 4 arrow keys with explanations as to what colors each 
  124.         one  controls.   The  adjacent  text  will  reflect  the  current 
  125.         foregraound  and  background colors so if you are altering colors 
  126.         on a blank PopUp screen,  you will still have a general  idea  of 
  127.         what  the  finished scree will look like.  The last option (Line) 
  128.         allows you to select between  the  current  Block  border  and  a 
  129.         double line border.  This option change to be the opposite of the 
  130.         current  displayed  border is.  Pressing 'L' (or 'B') will toggle 
  131.         between the two border options. Press the 'Q' option when you are 
  132.         satisfied with the appearance of the PopUp screen.  
  133.  
  134.  
  135.         Quitting PopEdit
  136.         ~~~~~~~~~~~~~~~~
  137.             If you have made any changes to the current PopUp  screen  in 
  138.         memory,  that  screen  will  be  displayed to you and you will be 
  139.         asked if you wish to save it. A word of caution here: There isn't 
  140.         any pactical way of insuring against all of the possible filename 
  141.         combinations you can enter here.  So,  the only checks  that  are 
  142.         made are in the filename extension - which MUST be .COM - and the 
  143.         total  length of the specified filename - which MUST be between 5 
  144.         and  12  characters.  BE  EXTREMELY  CAREFUL  when  entering your 
  145.         filename.  If there is an error,  PopEdit will inform you of  the 
  146.         error,  but  if  the save is being made through the Q)uit option, 
  147.         you will be returned to DOS WITHOUT  saving  the  edited  screen.  
  148.         The  filename  that appears in the square brackets is the default 
  149.         fielname.  If you simply hit [ENTER] at the filename prompt,  the 
  150.         default  filename  will  be  used.  If  that file already exists, 
  151.         PopEdit will inform you of that fact  and  ask  if  you  wish  to 
  152.         overwrite the existing file.  
  153.         
  154.         Reading in an existing PopUp
  155.         ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  156.             What  applies  for saving a PopUp also applies  to reading in
  157.         an existing PopUp.  Be careful with filenames and MAKE  SURE  you 
  158.         are  reading  in  the  same  size file as what you specified upon 
  159.         starting up PopEdit.  If the filesize is  not  the  same  as  you 
  160.         specified with the Small or Large choice, PopEdit will inform you 
  161.         of the error and return you to the main menu.  
  162.  
  163.         Disk Writing PopUp
  164.         ~~~~~~~~~~~~~~~~~~
  165.             This  option  allows you to save your current PoUp screen and 
  166.         start another of the same size.  Be sure to specify  a  different 
  167.         filename  for  the  next  screen  so that you don't overwrite the 
  168.         previous one by mistake!  
  169.         
  170.         Changing PopUp Sizes
  171.         ~~~~~~~~~~~~~~~~~~~~
  172.             This option allows you to to switch  from  editing  one  size 
  173.         PopUP  screen to  the other size.  If you have  made any changes,
  174.         PopEdit will ask if you wish to save your  current  PopUp  before 
  175.         switching. If you wish to save the current screen regardless, use 
  176.         the  D)isk  write  PopUP  option.  The Main Menu prompt line will 
  177.         display the current PopUp size in the square brackets.  
  178.         
  179.         Lastly,  there  are  areas  of checking I specifically left out - 
  180.         such in the area of DOS filename conventions - as I felt it would 
  181.         be better for the program  to  abort  rather  than  damaging  any 
  182.         existing PopUp files.  Regardless, I recommend that you copy your 
  183.         working  copy  of  PopEdit  and any existing PopUp files that you 
  184.         intend to read in and edit onto a separate diskette  or  into  an 
  185.         empty directory.  Do your editing there out of 'harm's way'! If 
  186.         you use PopEdit in this manner, you can then save the PopUp files 
  187.         you  create  using  the  default  filename.  Then,  once you exit 
  188.         PopEdit,  you can copy the PopUp files and rename them at the DOS 
  189.         level.  
  190.                                Enjoy...
  191.                                   Underdog-
  192.  
  193.